Getting started

To start working with Yandex Taxi:

1. Get a token for sending API requests:

   1. Log in to your Yandex Taxi Corporate Client Dashboard with the mail to which is attached your Yandex Go for business account.

   2. Go to the Company profile section.

   3. Click Get token.

   4. At oauth.yandex.ru, click Enter as "your login". You will be redirected to the Yandex Taxi Corporate Client Dashboard.

   5. You can find your OAuth token under Access token generated.

2. API tokens are valid for a limited time and then expire. Use the Update OAuth token request to get the lifetime of your token.

   • If the token lifespan is about to expire, run the Update OAuth token request again. This renews the token expiration date and you can continue using your current token.

   • If the token expires, get a new token in the Yandex Taxi Corporate Client Dashboard.

   Note

   If the token is lost, contact Yandex ID to reissue it.

3. Use the OAuth token in all API requests. Pass the token in the header:

   • In the API version 1.0: Authorization: <token value>.

   • In the API version 2.0: Authorization: Bearer <token value>.

   Note

   To work with the API 1.0, use the host https://business.taxi.yandex.ru, and to work with the API 2.0, use the host http://b2b-api.go.yandex.ru.

4. If one Yandex ID account has an access to several personal accounts, you have to specify the X-YaTaxi-Selected-Corp-Client-Id header for all requests as follows:

   1. In the personal account go to the Company profile tab.

   2. Transfer the client's ID to the header.

5. Enter cost center information.

6. Create user roles.

7. Add user accounts:

   • In the API version 1.0: Create a user.

   • In the API version 2.0: Create a user.

Ordering a ride

After you receive the token and add information about your users, you can use the Yandex Taxi API to order rides.

The ordering procedure is as follows:

1. Learn the price and conditions of your upcoming ride and get an offer.

2. Create a draft order.

3. Pass the order for processing.

4. If necessary, cancel the order.